home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / full_d.zip / D.MAN < prev    next >
Text File  |  1992-12-28  |  17KB  |  466 lines
  1.     
  2.     ********************************************************************
  3.  
  4.     
  5.     "D" - Directory, File, and Disk Information Tool        Version 2.11
  6.  
  7.     
  8.     --------------------------------------------------------------------
  9.  
  10.  
  11.     CONTENTS:
  12.     
  13.             (1) Introduction
  14.             (2) "D" versus "DIR"
  15.             (3) Syntax
  16.             (4) Imbedded pattern matching
  17.             (5) Multiple searchname patterns
  18.             (6) Model
  19.             (7) Case
  20.             (8) Fuzzy
  21.             (9) Hidden
  22.            (10) Color
  23.            (11) Detail
  24.            (12) Archive
  25.            (13) Subdir
  26.            (14) Skan
  27.            (15) Bonus switches (stats, change, actual) 
  28.            (16) Miscellaneous "D" techniques
  29.            (17) Versions
  30.     
  31.  
  32.     ********************************************************************
  33.  
  34.  
  35.     (1) INTRODUCTION:
  36.  
  37.     This documentation is to supplement the on-line documentation in "D"
  38.     that you may view any time by typing "D/HELP" or "D/?".    "D"'s on-
  39.     line documentation explains all features, and gives a few examples.
  40.  
  41.     This documentation avoids  repeating information exactly as the HELP
  42.     screen presents it.  Your best success at using "D" will be achieved
  43.     by reading both this documentation AND the on-line help.
  44.  
  45.     You may find some features are  elaborated on  a little more in this
  46.     documentation since the  on-line screens  dictate a more brief pres-
  47.     entation.
  48.  
  49.     Generally speaking, "D" is an enhanced alternative to the  DIR  com-
  50.     mand.  It is  not limited  by the current directory  or by the usual
  51.     limitations of DOS filename patterns.
  52.  
  53.     "D" displays the Directory entries first, then the Hidden files, and
  54.     finally, the rest of the files.   They are always sorted alphabetic-
  55.     ally, and  (if the Pretty switch is active)  displayed in  different
  56.     colors based on the most common file extensions.
  57.  
  58.     When  using  either color  option  (Pretty or Color),  the directory
  59.     entries are displayed in  Light Green;  the Hidden files,  which are
  60.     also grouped together, are displayed in Light Magenta.  You will see
  61.     that some file entries have the letter "A" appended to them in Light
  62.     Blue.  This indicates that the archive bit is set.
  63.     
  64.     
  65.     ********************************************************************
  66.  
  67.     
  68.     (2) "D" VERSUS "DIR":
  69.  
  70.     "D" is first and foremost a replacement for the DIR command.  To be-
  71.     come a skilled user of  "D"  you should first use it instead of DIR.
  72.     You will see  the same information,  but it will be  more organized,
  73.     and more informative.  Using  "D"  in this context will allow you to
  74.     increase  your  level  of  information,  and  do  so in a more space
  75.     efficient way than DIR provides.
  76.  
  77.     To use "D" as a simple replacement for the DIR command just type "D"
  78.     followed by the searchname:
  79.                                  D AUTOEXEC.BAT
  80.     instead of using DIR, as in:
  81.                                  DIR AUTOEXEC.BAT
  82.  
  83.     "D" will accept the same search arguments as  DIR  does, but removes
  84.     the limitations by alowing you to imbed one or more asterisks in the
  85.     searchname and by allowing you to specify  more than one  searchname
  86.     at a time.
  87.  
  88.     By default  "D"  looks only in the  current directory  just like DIR
  89.     does, but the searching may be increased to the current and all sub-
  90.     ordinate directories, or to the entire disk  based on your choice in
  91.     the form of a command line switch or an environmental variable.
  92.  
  93.     "D" will display any file or directory on your drive.  Using the DIR
  94.     command can  cause you  to overlook  files and directories  that you
  95.     were unable to see.  Hidden and archived files are  easily recogniz-
  96.     able with "D".
  97.  
  98.  
  99.     ********************************************************************
  100.  
  101.  
  102.     (3) SYNTAX:
  103.  
  104.     D /switch(es) searchname(s)      OR      D searchname(s) /switch(es)
  105.  
  106.     The searchname is similar to the DOS standard filename with wildcard
  107.     characters  allowed.   Imbedded  pattern matching  is supported, and
  108.     multiple searchnames  can be specified  by connecting them with plus
  109.     signs.
  110.  
  111.     Switch values are 1 character in length.  The  first switch  must be
  112.     preceded by  a slash (/).   If more than 1 switch is specified,  the
  113.     2nd through last switches cannot have spaces between them.  Switches
  114.     can have the following values:
  115.  
  116.        Switch   Valid Values (Just use capitilized letter of Value)
  117.        -------  -----------------------------------------------------
  118.        model    LMTF  Large,      [M]edium,  Tiny,   best Fit
  119.        case     UXW   Upper,      mi[X]ed,   loWer
  120.        fuzzy    ZE    fu[Z]zy,    Exact
  121.        hidden   HR    [H]idden,   Regular only
  122.        color    PCB   [P]retty,   Color,     Black&white
  123.        detail   OG    Omit files, Grand total only
  124.        archive  A     Archive files only
  125.        subdir   SD    Subdirectories, entire Disk
  126.        skan     K     sKan target drive
  127.  
  128.        stats    %     display disk used/free as percentage (%)
  129.        change   *     change to displayed directory (*)
  130.        actual   #     display byte counts as actual bytes allocated (#)
  131.     
  132.     If you almost always specify a certain switch, you can save yourself
  133.     some keystrokes by setting the environmental variable  DSET equal to
  134.     the value of the switch(es).    For example,  if you would prefer to
  135.     see the filenames displayed in upper case, then at the  DOS  prompt,
  136.     you would type:
  137.                     C:\> SET DSET=U
  138.  
  139.     The DSET values  override the  default values,  and the command line
  140.     values will override the DSET values.
  141.  
  142.  
  143.     ********************************************************************
  144.  
  145.  
  146.     (4) IMBEDDED PATTERN MATCHING:
  147.  
  148.     If you don't quite remember the name of a file, but remember a frag-
  149.     ment of it's name, you can use  D's imbedded pattern searching logic
  150.     to help you remember.
  151.  
  152.     Let's say  you remember the file's name  had the string "YES" in it,
  153.     but you can't remember if the "YES" was in the beginning, middle, or
  154.     the end of the file's name. Also, to make things more difficult, you
  155.     can't remember which directory it's in. "D" will take care of you if
  156.     you type:
  157.                D/D *YES
  158.  
  159.     If the fuZzy switch is in effect, this will have  the same effect as
  160.     if you had typed D/D *YES*.*.
  161.  
  162.     Since the DIR command will only allow the "*" to be the last charac-
  163.     ter in  a file  or  extension name, this feature should be a welcome
  164.     alternative.
  165.  
  166.     Important definition:  "*"  <---- The asterisk says "zero or more of
  167.     any character."
  168.  
  169.     You can mix asterisk's and other characters freely, for example:
  170.  
  171.                    D *U*O*X
  172.  
  173.     would find AUTOEXEC.BAT and UTOEXEC.BAT and AUTOEX.DAT
  174.  
  175.     Another definition:  "?"  <----- each question mark says "one of any
  176.                                      character except when the "?" is at
  177.                                      the end of the  searchname in which
  178.                                      case it means zero or one character
  179.                                      to comply with the DOS standard".
  180.  
  181.  
  182.     ********************************************************************
  183.  
  184.     
  185.     (5) MULTIPLE SEARCHNAME PATTERNS:
  186.  
  187.     "D" does not limit you to 1 SEARCHNAME!   Let's say you just want to
  188.     select the .BAT files and the .EXE files. Type:
  189.                                                     D *.BAT+*.EXE
  190.     
  191.     Use the plus sign  (+)  to connect the searchnames.   If you want to
  192.     find all of the HELP files on your drive, you could do 2 searches:
  193.  
  194.                     D/D *H*LP
  195.                     D/D *.HLP
  196.  
  197.     But you'd find all of the same files by typing:
  198.  
  199.                     D/D *H*LP+*.HLP
  200.  
  201.     Of course you don't need to use wildcards:
  202.  
  203.                     D AUTOEXEC.BAT+CONFIG.SYS
  204.  
  205.     There would be  no limit  to the  number of searchnames that you can 
  206.     connect, but the DOS command line is only "so long" (128 characters,
  207.     or something like that).   Do feel free to type as many names as you
  208.     want to as long as there's room to type them!
  209.  
  210.     Limitation:  Only the first SEARCHNAME can refer to a disk/directory
  211.                  path,  the second  through the Nth SEARCHNAMES are only
  212.                  examined for their FILE and EXTENSION values.
  213.  
  214.                  In other words the target drive and/or directory is de-
  215.                  termined solely by examining the first SEARCHNAME.
  216.     
  217.  
  218.     ********************************************************************
  219.  
  220.     
  221.     (6) MODEL:
  222.  
  223.     Use the model parameter to determine  how much  information you will
  224.     see:
  225.         L  = Filename, Extension, Size, Date & Time, Attribute
  226.        [M] = Filename, Extension, Size, Attribute
  227.         T  = Filename, Extension, Attribute
  228.  
  229.         F  = Best Fit.  The largest model that will fit all filenames on
  230.              1 screen will be chosen.  If that is physically impossible,
  231.              the Tiny model is chosen.
  232.  
  233.     
  234.     ********************************************************************
  235.  
  236.     
  237.     (7) CASE:
  238.  
  239.     Determines  whether  the  file  information  is  displayed in UPPER,
  240.     lower, or Mixed case:
  241.  
  242.         U  = UPPER CASE
  243.        [X] = Mixed Case
  244.         L  = lower case
  245.     
  246.  
  247.     ********************************************************************
  248.  
  249.  
  250.     (8) FUZZY:
  251.  
  252.     Can be used to automatically make all searches look for whatever you
  253.     type as your searchname  PLUS  anything else  that  starts with that 
  254.     pattern.
  255.  
  256.     When fuzziness  is active,  typing  "D TEST"  is the same  as typing
  257.     "D TEST*.*".     
  258.  
  259.     Also, typing "D TEST.B" is the same as typing "D TEST.B*".
  260.  
  261.     If you'd prefer to be consistant with the DOS standard which doesn't
  262.     append "*"'s, use the E switch.
  263.  
  264.        [F] = Fuzzy
  265.         E  = Exact
  266.     
  267.     
  268.     ********************************************************************
  269.  
  270.     
  271.     (9) HIDDEN:
  272.  
  273.     The Hidden switch decides if you see the hidden/system files of not.
  274.  
  275.     This also means that the total  files  and  bytes won't  reflect the
  276.     totals of the hidden/system files.   Unless  you specify  the "O" or
  277.     "G" parameter, only displayed files are totalled.
  278.  
  279.        [H] = Hidden and Regular
  280.         R  = Regular only
  281.  
  282.     
  283.     ********************************************************************
  284.  
  285.     
  286.     (10) COLOR:
  287.  
  288.     The color option can be used  to enhance the readability of the dis-
  289.     play.  If you have an LCD screen, use the  "B"  switch.   Otherwise,
  290.     you'll probably want to choose between "P" or "C".    The "C" switch
  291.     causes the display to be in plain color mode.    The "P" switch will
  292.     show the files in different colors based on the file extension.
  293.  
  294.        [P] = Pretty
  295.         C  = Color
  296.         B  = Black & White (LCD)
  297.  
  298.  
  299.     ********************************************************************
  300.  
  301.  
  302.     (11) DETAIL:
  303.  
  304.     This option will eliminate  the filenames  from the display,  giving
  305.     you just the counts and totals.    Using the "O" switch (omit files)
  306.     is most useful if you are doing  a subdirectory or full disk search,
  307.     and want to see the totals by directory.  To say "Omit files" is the
  308.     same thing as saying "directory totals only."    To just see a grand
  309.     total, use the  "G"  switch; you won't see totals by directory,  but
  310.     you will get  a count  for number of directories in addition to file
  311.     counts and byte quantities.
  312.  
  313.     If you are just focusing on 1 directory,  there is no practical dif-
  314.     ference between using "G" and "O".
  315.  
  316.         O  = Omit Files (Directory Totals Only)
  317.         G  = Grand Total Only
  318.  
  319.  
  320.     ********************************************************************
  321.  
  322.  
  323.     (12) ARCHIVE:
  324.  
  325.     When the  "A"  switch  is used,  only files with the archive bit set
  326.     will be chosen.  If you regularly clear your archive bits by backing
  327.     up  or  some  other  method,  this option will make it easy to track
  328.     which files you've changed or added.   If you want to look at all of
  329.     the archived files on your disk, type "D/AD".    If you just want to
  330.     know the total of all archived files, type "D/ADG".
  331.  
  332.         A  = Only find archived files
  333.  
  334.     Archived files are indicated by the letter  "A"  to the right of the
  335.     archived file.
  336.  
  337.  
  338.     ********************************************************************
  339.  
  340.  
  341.     (13) SUBDIR:
  342.  
  343.     Use the Subdir option to determine the scope of  your searches  rel-
  344.     ative to the target directory.    Using "S" will cause the search to
  345.     execute for  whatever the target directory is,  and extends into any
  346.     directorys subordinate to (beneath) it.    If you want your searches
  347.     to look over the entire disk, just use the "D" switch.
  348.  
  349.     These switches make it possible for you to find a file (or files) no
  350.     matter where they exist.   They also make totalling and listing much
  351.     more flexible.
  352.                                   
  353.         S  = Current and Subordinate Subdirectorys
  354.         D  = Entire Disk
  355.  
  356.  
  357.     ********************************************************************
  358.    
  359.  
  360.     (14) SKAN:
  361.  
  362.     Yes, I know it's usually spelled differently, but the "C" switch was
  363.     used up by the time I got to this one!
  364.  
  365.     Anyway, the skan option causes the file of  directory names  used by
  366.     "D" to be updated or created.  There is one file for each drive ever
  367.     skanned except for A: and B:.     The files have the .TRE extension,
  368.     and are created and maintained in the  same directory  that contains
  369.     "D.EXE".  The files are used for Subdirectory or Full Disk searches.
  370.  
  371.     The first time you search a disk with the  "S"  or  "D"  option, the
  372.     file for that drive is created.    After that,  you must remember to 
  373.     use this option whenever you add a new subdirectory. This might seem
  374.     a little inconvenient, but saves you beaucoup time,  especially when
  375.     searching the entire disk.  
  376.  
  377.         K  = Skan the drive being searched to
  378.              rebuild the directory table.
  379.  
  380.  
  381.     ********************************************************************
  382.  
  383.     
  384.     (15) BONUS SWITCHES:
  385.  
  386.     Not much explanation needed for these  simple purpose  switches, but
  387.     they sure do come in handy occasionally!
  388.  
  389.     Use "%" (stats) when you want  to see  the disk  used and free quan-
  390.     tities expressed  as percentages  on the bottom line  instead of the
  391.     default byte counts.  The  total quantity  for the disk is still ex-
  392.     pressed as a byte count.
  393.  
  394.     Use  "*"  to (change) to the most recently viewed directory after it
  395.     has been displayed.
  396.  
  397.     The "#" (actual) switch causes the byte counts on the top line,  and
  398.     for each displayed file entry  to reflect the actual number of bytes
  399.     allocated for the file on the target drive.   It is assumed that you
  400.     understand that the smallest unit of allocation that  DOS can use is
  401.     a cluster.  It then follows that all byte counts will be evenly div-
  402.     isible by the cluster size of the target drive.
  403.  
  404.  
  405.        % = display disk used/free as percentage 
  406.        * = change to displayed directory 
  407.        # = display byte counts as actual bytes allocated 
  408.         
  409.     
  410.     ********************************************************************
  411.  
  412.  
  413.     (16) MISCELLANEOUS "D" TECHNIQUES
  414.  
  415.  
  416.     --------------------------------------------------------------------
  417.  
  418.  
  419.     If you have a filename on drive C:, and you want to go to the direc-
  420.     tory where it is, just type:
  421.                                  D/*D searchname.ext
  422.  
  423.     It doesn't matter  which directory you're in,  you will be  taken to
  424.     the directory where that file is.  If more  than one directory get's
  425.     a "hit",  each one will be displayed,  and  you can terminate "D" by
  426.     hitting the Esc key when your chosen directory is displayed.
  427.  
  428.  
  429.     --------------------------------------------------------------------
  430.  
  431.  
  432.     To get  the size of the current directory  in a 1 line display, just
  433.     type: 
  434.                           D/O
  435.  
  436.     To get the size of the current and all subdirectories, one line each
  437.     directory, just type:
  438.                           D/OS
  439.  
  440.     To get the size of the current and all sub directories, one line for
  441.     number of directories, files, and bytes, type:
  442.  
  443.                           D/GS
  444.  
  445.  
  446.     --------------------------------------------------------------------
  447.  
  448.  
  449.     To find all of the archived files on your drive, type: D/AD
  450.  
  451.  
  452.     ********************************************************************
  453.  
  454.  
  455.     (17) "D" VERSIONS:
  456.  
  457.         1.10 - The original shareware Version
  458.         1.11 - Colors added based on file extensions - ([P]retty Switch)
  459.         1.12 - Colors refined based on actual feedback
  460.         2.10 - Multiple Searchnames enabled
  461.         2.11 - Option to display byte counts as bytes allocated
  462.     
  463.     
  464.     ********************************************************************
  465.  
  466.